﻿<!DOCTYPE HTML>
<html lang="zh">
<head>
<title>WinSetTransColor - 语法 &amp; 使用 | AutoHotkey v2</title>
<meta name="description" content="The WinSetTransColor function makes all pixels of the chosen color invisible inside the specified window." />
<meta name="ahk:equiv-v1" content="lib/WinSet.htm#TransColor" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<link href="../static/theme.css" rel="stylesheet" type="text/css" />
<script src="../static/content.js" type="text/javascript"></script>
</head>
<body>

<h1>WinSetTransColor</h1>

<p>使所选颜色的所有像素在指定的窗口内不可见(透明).</p>

<pre class="Syntax"><span class="func">WinSetTransColor</span> Color <span class="optional">, WinTitle, WinText, ExcludeTitle, ExcludeText</span></pre>

<h2 id="Parameters">参数</h2>
<dl>
    <dt>Color</dt>
    <dd>
        <p>类型: <a href="../Concepts.htm#strings">字符串</a>或<a href="../Concepts.htm#numbers">整数</a></p>
        <p>指定一个颜色名称或 RGB 值(请参阅<a href="../misc/Colors.htm">颜色列表</a>以获得指导, 或在 RGB 模式下使用 <a href="PixelGetColor.htm">PixelGetColor</a>). 如果要使窗口的可见部分部分透明(半透明), 请在透明度级别(0-255) 后面添加一个空格(不是逗号). 例如: <code>WinSetTransColor "EEAA99 150", <i>WinTitle</i></code>.</p>
        <p>如果值是一个字符串, 任何数字颜色值必须是十六进制的格式. 颜色值可以省略; 例如, <code>WinSetTransColor " 150"</code>(带前导空格) 等同于 <code>WinSetTransparent 150</code>.</p>
        <p>单词 <code>"Off"</code>(不区分大小写) 可以完全关闭窗口的透明度. 这与 <code><a href="WinSetTransparent.htm">WinSetTransparent</a> "Off", <i>WinTitle</i></code> 功能相同. 指定 <code>"Off"</code> 与指定 255 不同, 因为它可能会提高性能并减少系统资源的使用(但可能只在禁用桌面合成时).</p>
    </dd>
    <dt>WinTitle</dt>
    <dd>
        <p>类型: <a href="../Concepts.htm#strings">字符串</a>, <a href="../Concepts.htm#numbers">整数</a>或<a href="../Objects.htm">对象</a></p>
        <p>识别目标窗口的窗口标题或其他条件. 请参阅 <a href="../misc/WinTitle.htm">WinTitle</a>.</p>
    </dd>
    <dt>WinText</dt>
    <dd>
        <p>类型: <a href="../Concepts.htm#strings">字符串</a></p>
        <p>如果存在, 此参数必须是目标窗口的单个文本元素的子字符串(和内置的 Window Spy 工具显示的一样). 如果 <a href="DetectHiddenText.htm">DetectHiddenText</a> 为 ON, 那么会检测隐藏文本元素.</p>
    </dd>
    <dt>ExcludeTitle</dt>
    <dd>
        <p>类型: <a href="../Concepts.htm#strings">字符串</a></p>
        <p>标题中含有此参数值的窗口将被排除.</p>
    </dd>
    <dt>ExcludeText</dt>
    <dd>
        <p>类型: <a href="../Concepts.htm#strings">字符串</a></p>
        <p>文本中含有此参数值的窗口将被排除.</p>
    </dd>
</dl>

<h2 id="Error_Handling">错误处理</h2>
<p>如果找不到窗口, 则抛出 <a href="Error.htm#TargetError">TargetError</a>.</p>
<p>如果无法应用更改, 则抛出 <a href="Error.htm#OSError">OSError</a>.</p>

<h2 id="Remarks">备注</h2>
<p>这使得后面的窗口内容可以显示出来. 如果用户点击一个不可见的像素, 点击会 "穿透" 到后面的窗口.</p>
<p>要改变一个窗口现有的 TransColor, 可能需要在改变之前关闭透明度.</p>
<p>鼠标光标下的窗口的 ID 可以使用 <a href="MouseGetPos.htm">MouseGetPos</a> 来获取.</p>
<p>窗口标题和文本是区分大小写的. 除非 <a href="DetectHiddenWindows.htm">DetectHiddenWindows</a> 被打开, 否则不会检测隐藏窗口.</p>
<p>此函数常用来创建屏幕显示(OSD) 和其他视觉效果. <a href="Gui.htm#ExOSD">在 Gui 对象页面的底部</a>有一个屏幕显示的例子. 有关通过热键的简单演示, 请参阅在 <a href="WinSetTransparent.htm">WinSetTransparent</a> 页面的<a href="WinSetTransparent.htm#ExTransHotkey">示例 #4</a>.</p>
<p>这个函数经常被用来创建屏幕上的显示和其他视觉效果. <a href="Gui.htm#ExOSD">在 Gui 对象页面的底部</a>有一个屏幕显示的例子. 通过热键进行简单的演示, 请参阅 <a href="WinSetTransparent.htm">WinSetTransparent</a> 页面的<a href="WinSetTransparent.htm#ExTransHotkey">示例 #3</a>.</p>

<h2 id="Related">相关</h2>
<p><a href="WinSetTransparent.htm">WinSetTransparent</a>, <a href="Win.htm">窗口函数</a>, <a href="Control.htm">控件函数</a></p>

<h2 id="Examples">示例</h2>
<div class="ex" id="ExBasic">
<p><a class="ex_number" href="#ExBasic"></a> 使记事本中的所有白色像素都不可见. 这个例子在 Windows 11 或更高版本的新记事本上可能不能很好地工作.</p>
<pre>WinSetTransColor "White", "Untitled - Notepad"</pre>
</div>

</body>
</html>